ox-texinfo:: Require only TEXINFO_DIR_CATEGORY
authorStefan Monnier <monnier@iro.umontreal.ca>
Sat, 2 Mar 2024 19:48:29 +0000 (14:48 -0500)
committerStefan Monnier <monnier@iro.umontreal.ca>
Sun, 3 Mar 2024 21:57:56 +0000 (16:57 -0500)
commit5254c582efb3e7171e955dde653e7530d2d3ffef
tree3d3ba6364d647e6f06db272d481f3062da4c2b37
parentdb7b87867b3002d72444f06110e3625aa8de680e
ox-texinfo:: Require only TEXINFO_DIR_CATEGORY

Until now @dircategory/@direntry entries were added only if
both TEXINFO_DIR_CATEGORY and TEXINFO_DIR_TITLE were set.
And the setting of TEXINFO_DIR_TITLE had to be careful to
provide exactly the right syntax.

This patch changes various things in this regard:
- Only require TEXINFO_DIR_CATEGORY in order to generate
  `@dircategory` and `@direntry`.
- Use the document title by default if TEXINFO_DIR_DESC is missing.
- Use the filename by default when TEXINFO_DIR_TITLE is missing.
- Try and make it harder to provide a direntry that does not
  have the right format or refers to a different filename than
  the one we're outputting to.

* lisp/org/ox-texinfo.el: Remove redundant `:group` arguments.
Prefer #' to quote function names.
(org-texinfo-template): Use sane defaults for `@direntry`.

* doc/misc/org.org (Texinfo specific export settings): Adjust accordingly.
doc/misc/org.org
lisp/org/ox-texinfo.el